SetDeviceAttribute

SetDeviceAttribute
Header:	Quickdraw.h		Carbon status:	Supported

Sets the attribute bits of a GDevice structure.

void SetDeviceAttribute (
    GDHandle gdh, 
    SInt16 attribute, 
    Boolean value
);

Parameter descriptions

gdh: A handle to a GDevice structure.
attribute: One of the specific constants, which represent bits in the gdFlags field of a GDevice structure. See “Device Attribute Constants” for the values you can use in this parameter.
value: A value of either 0 or 1 for the flag bit specified in the attribute parameter.

DISCUSSION

For the graphics device specified in the gdh parameter, the SetDeviceAttribute function sets the flag bit specified in the attribute parameter to the value specified in the value parameter.

Your application should never directly change the gdFlags field of the GDevice structure; instead, use only the SetDeviceAttribute function.

SPECIAL CONSIDERATIONS

The SetDeviceAttribute function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.